Contexto global

WriteJSON

Sintaxis:

WriteJSON(<JSONWriter>, <Valor>, <ConfiguraciónDeSerialización>, <NombreDeFunciónDeConversión>, <MóduloDeFunciónDeConversión>, <ParámetrosAdicionalesDeFunciónDeConversión>)

Parámetros:

Tipo: JSONWriter.
Objeto a través del cual se ejecuta un registro JSON. El hilo JSON debe estar preparado para los valores de los registros.

Tipo: Arbitrario.
Un objeto de registro JSON. Cambia el estado del flujo de registros.
Un valor de tipo arbitrario.
Solo se pueden escribir los valores de los siguientes tipos en formato JSON:

• Cadena,
• Número,
• Booleano,
• Fecha (convertida a cadena),
• Array,
• FixedArray,
• Estructura,
• FixedStructure,
• Mapa,
• FixedMap.

La clave de correspondencia (o correspondencia fija) debe ser del tipo Cadena. De lo contrario, se generará una excepción.
Si se transfiere un valor diferente de los enumerados, debe convertirse con la función de conversión.
Si se escribe un valor de tipo no válido, se generará una excepción.

Tipo: JSONSerializerSettings.
Configuración de serialización en JSON.

Tipo: Cadena.
Esta función se llama para todas las propiedades si sus tipos no admiten una conversión directa al formato JSON. Debe convertir el Valor en un valor permitido para el registro de tipo JSON.
La función debe ir precedida de las directivas OnServer o OnClient. Esta función no está permitida fuera del contexto de formulario, módulo o comando.
La función debe ser exportada y debe tener los siguientes parámetros:

• <Propiedad> Se transfiere el nombre de la propiedad al parámetro si se escribe una estructura o un mapeo.
• <Valor> Se transfiere el valor de origen al parámetro.
• <ParámetrosAdicionales> Parámetros adicionales especificados en la llamada al método WriteJSON.
• <Cancelar> Cancela la operación de escritura de la propiedad.

Si la función devuelve un objeto que no admite la conversión a JSON, se generará una excepción.
Si se establece este parámetro, pero no se establece el parámetro <MóduloDeFunciónDeConversión>, o viceversa, se generará una excepción.
Valor predeterminado: Indefinido.

Tipo: Arbitrario.
Especifica el módulo en el que se implementa la función de conversión a JSON.
Valor predeterminado: Indefinido.

Tipo: Arbitrario.
Parámetros adicionales que se transferirán a la función de conversión.
Valor predeterminado: Indefinido.

Descripción:

Serializa <Valor> en formato JSON y almacena el resultado en el objeto <JSONWriter>.
Si necesita ejecutar este método con un tipo que no está permitido, puede usar una función de conversión (parámetros <NombreDeFunciónDeConversión> y <MóduloDeFunciónDeConversión>).

Disponibilidad:

Cliente ligero, cliente móvil, servidor, cliente grueso, conexión externa, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil.

Nota:

La lista de tipos que se pueden serializar en formato JSON utilizando este método es limitada.
Se pueden serializar valores de los siguientes tipos en formato JSON:

• Indefinido
• Booleano
• Número
• Cadena
• Fecha (se convertirá en cadena)
• Estructura
• FixedStructure
• Array
• FixedArray
• Mapa
• FixedMap

Esta lista puede ampliarse más adelante.
Un intento de serializar un tipo que no está permitido genera una excepción.

Disponible desde:

Disponible desde la versión 8.3.6.

Descripción cambiada en la versión 8.3.23.